### Lucid Waters SDDM Theme Information

    This is the Offical SDDM Display Manager Greeter Theme for Parabola GNU Linux 

### Lucid Waters SDDM Theme License Information

Image License:
    Creative Commons Attribution 3.0 (CC-By-3.0)
    https://creativecommons.org/licenses/by/3.0/legalcode
    https://notabug.org/lucideagle/lucid-waters-sddm-theme

Software License: 
    GNU Public License Version 3.0 (GPLv3)
    https://www.gnu.org/licenses/gpl-3.0.en.html
    https://notabug.org/lucideagle/lucid-waters-sddm-theme

Video License: 
    Creative Commons Attribution 3.0 (CC-By-3.0)
    https://creativecommons.org/licenses/by/3.0/legalcode
    https://www.videvo.net/profile/creativefilm/
    
### Lucid Waters SDDM Theme Video Playlists 

The current video of a peaceful waterfall is set to play on an infinite loop.

If you would like to modify this theme to add additional videos to the playlists. Videos are played randomly and diferent playlists are used based on time of day with day and night time playlists. 

- Day Time Playlist Automatically Plays between 5:00 AM - 5:00 PM.
- Night Time Playlist Automatically Plays between 5:00 PM - 5:00 AM.

As of right now there is only 1 long format timelapse video for the playlist_day.m3u and playlist_night.m3u. 

More videos will be added to the playlist in future version releases. 

### Lucid Waters SDDM Theme Dependencies

[Arch Based Systems] 

    sudo pacman -S gst-libav phonon-qt5-gstreamer gst-plugins-good

[Ubuntu Based Systems] 

    sudo apt-get install gst-libav phonon-qt5-gstreamer gst-plugins-good

[Red Hat Based Systems]

    sudo yum install gst-libav phonon-qt5-gstreamer gst-plugins-good

### Lucid Waters SDDM Theme Installation

To manually install the Lucid Waters SDDM Theme simply clone it from the GIT Repository. 

    git clone git@notabug.org:lucideagle/lucid-waters-sddm-theme.git

Then simply copy the theme to /usr/share/sddm/themes/ with super user privledges enabled. 

    su
    mv lucid-waters /usr/share/sddm/themes

Open up the /etc/sddm.conf file via the terminal.

    sudo nano /etc/sddm.conf

 Search for and change the SDDM theme to "lucid-waters" to enable it as the default theme upon start up.

    [Theme]
    Current=lucid-waters

    
### Lucid Waters SDDM Theme Testing

The Lucid Waters SDDM Theme can be tested by running the following command in the terminal.

    sddm-greeter --theme to /usr/share/sddm/themes/lucid-waters

### Developer Notes

There is an option to stream HD videos with a good internet connection if you would like to add remote video content in the future. If there is no active connection or the video can't be played the background will fallback to the image background.jpg

If you want to add and/or change the local videos files that came with this theme. Use the following command to generate the playlist-file (playlist_day.m3u or playlist_night.m3u) from a directory containing the new videos.

    su
    find path-to-your-directory -maxdepth 1 -type f > playlist-file-name

### Changing Theme Settings In `theme.conf.user`

    sudo nano to /usr/share/sddm/themes/lucid-waters/theme.conf.user
    
Here are a few of the settings which can be adjusted for the Lucid Waters SDDM Theme to your specifications.

    - background:   default background image
    
    - background_day / background_night:    current video playlists
    
    - displayFont:  default font selected for the Lucid Waters SDDM Theme 
    
    - showLoginButton:  If set to false this option will hide the login button
    
    - showClearPasswordButton:  if set to false will hide the clear password button that appears when text is inputed
    
    - passwordLeftMargin & usernameLeftMargin:   set margin input boxes, labels, and fix any text overlaping
    
    - relativePositionX & relativePositionY: Where to set the exact position for the login text box and clock
    
### Software Code Source Information 

    This software is originally forked from the Aerial SDDM Theme 
    GIT Repository URL: https://github.com/3ximus/aerial-sddm-theme
    
### Lucid Waters SDDM Theme Previews

    See the to-do list via usr/share/sddm/themes/lucid-waters/TODO.md
